home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / ragtagpc.arc / RAGTAGPC.DOC < prev   
Encoding:
Text File  |  1990-04-26  |  8.3 KB  |  191 lines
  1. RagTag 0.03
  2.  
  3. ProComm Plus script to add taglines to messages entered online, using 
  4. the John Hancock tagline program, version 2, by Dan Moore
  5.  
  6. (So far as I am aware, ProComm 2.4.2's script language lacks the ability 
  7. to open, read, and close files, so this script cannot be adapted for use 
  8. with ProComm 2.4.2.)
  9.  
  10. Author: Maurice Crouse
  11.  
  12.  
  13. WHAT'S NEW
  14.  
  15. RagTag 0.03 uses John Hancock version 2, which is much more versatile 
  16. than version 1.
  17.  
  18.  
  19. PURPOSE
  20.  
  21. RagTag is a ProComm Plus script written for those persons who wish to 
  22. use Dan Moore's John Hancock program, version 2, to add taglines to 
  23. messages entered online.  Why would anyone want to do this?  I don't 
  24. know.  Why DO you want to do it?
  25.  
  26. Presumably you want to give the impression that you're using an offline 
  27. reader when you're not in fact doing it.  Frankly, it would be a lot 
  28. simpler and faster if you just typed in a fake reader name and a 
  29. tagline, but if you want to go to the trouble of using RagTag to do 
  30. it, you're certainly welcome.
  31.  
  32.  
  33. CONTRIBUTION
  34.  
  35. No, I'm not asking for a contribution; I'm making one.
  36.  
  37. RagTag is hereby contributed to the public domain, if the public domain
  38. will have it.  It is nothing that you as a competent ASPECT script 
  39. programmer could not have written for yourself if you had put your mind 
  40. to it for a couple of hours, as I did, so I see no point in asking you 
  41. to pay for it.  You probably wouldn't pay for it even if I asked you, so 
  42. there's no point in making you feel guilty either.
  43.  
  44. You may make any changes or modifications to RagTag that you please.  
  45. To save you the effort of decompiling, disassembling, or reverse- 
  46. engineering it, the .ASP file is freely made available.  (What else 
  47. could I do?  ASPECT scripts can't be compiled, anyway.)  If you know 
  48. anything at all about ASPECT scripting, you can create your own version 
  49. of RagTag, even to the point of changing the logo that it sends with the 
  50. tagline.
  51.  
  52.  
  53. LIMITED WARRANTY
  54.  
  55. I make no warranty of any kind, either expressed, implied, or inferred.  
  56. The program isn't guaranteed to do anything.  It may not even work for 
  57. you; if it does, it may not work the way you want it to work.  It works 
  58. on my machine and the way I want it to work, which is more than I can 
  59. say for some people's programs.  If RagTag is not to your liking, 
  60. rewrite it or throw it away.
  61.  
  62. RagTag is known to have great difficulty working with boards that run 
  63. QBBS software, for some reason unknown to me.  Taglines may be entirely 
  64. rejected or severely garbled.  I *told* you it might not even work.
  65.  
  66.  
  67.  
  68. LICENSE TO COPY
  69.  
  70. You are granted a license to copy RagTag for others subject to the 
  71. following limitation:
  72.  
  73. You must give the others fair warning that the software is probably 
  74. useless and that it will not be supported.
  75.  
  76. Operators of electronic bulletin board systems (sysops) may post 
  77. RagTag for downloading by their users, or they may trash it as soon as 
  78. they can get the opportunity.
  79.  
  80.  
  81. RagTag SETUP
  82.  
  83. Versions of RagTag earlier than 0.03 required that version 1 of the John 
  84. Hancock programs written by Dan Moore be used.  Why?  Because Dan wrote 
  85. version 2 in such a sneaky way that there was no way to tell what the 
  86. .REP file would be named.  Without my script knowing the name it was 
  87. just stumbling in the dark with a 1 in 26 chance of getting it right.  I 
  88. thought it better to have a program that worked 100% of the time than 
  89. just 3.85% of the time.  Finally, by an ingenious programming trick, I 
  90. was able to get RagTag 0.03 to work with version 2 of John Hancock.  
  91. (Check the .ASP file to see what the trick is.)  Well, I did get a 
  92. little bit of help from an expert programmer with that one, but I had 
  93. thought of the idea before he suggested it.  Frankly, I had thought it 
  94. wouldn't work and was amazed when it did.  Now you no longer have to 
  95. keep both versions of JH around; you can use JH2 with your DeLuxe or EZ 
  96. reader *and* with RagTag.
  97.  
  98. Using an ASCII editor, edit RAGTAG.ASP so that the variable S4 reflects 
  99. the directory in which you already have or plan to put JH.EXE, JH.CFG, 
  100. and JH.TAG.  Edit it further so that the variable S5 reflects the 
  101. directory in which PCPLUS.EXE is located.  Save RAGTAG.ASP to the 
  102. directory in which you ordinarily keep your ProComm Plus scripts.
  103.  
  104. If they are not there already, copy JH.EXE and JH.CFG to your favorite 
  105. directory, the one you have identified in the S4 variable in RAGTAG.ASP.  
  106. You must also copy at least JH.TAG to that directory.  This is an 
  107. ordinary ASCII file of taglines which you may create for yourself.  Or, 
  108. if you're like me or Bud Schrimsher, you may steal taglines that others 
  109. have written.  (The first time JH runs, it looks for JH.TAG.  If you 
  110. have other .TAG files you may copy them to the directory also, and you 
  111. may switch from one to another using the directions in the JH 
  112. documentation.)
  113.  
  114.  
  115. RagTag USAGE
  116.  
  117. When you have finished writing the last word of your message online, 
  118. press <Return> to get to a new line.  (Don't press <Return> more than 
  119. once, however, because on many systems, especially PCBoard, two <Return> 
  120. characters in a row will throw you out of the editing mode.)
  121.  
  122. Press <Alt><F5> to open up the Scripts window; enter RAGTAG as the 
  123. script name.
  124.  
  125. Choose the tagline using the instructions in the JH documentation.  I 
  126. could tell you how to do this, but if you don't already know how, you 
  127. don't have any business using RagTag yet.  You've got to learn how to 
  128. crawl before you can walk.
  129.  
  130.  
  131. RagTag AUTOSAVE
  132.  
  133. There isn't any.  The procedure for saving varies so much from one 
  134. board's software to another that it's impossible to write an autosave 
  135. routine that will work for all of them.  It's up to you to save your own 
  136. messages in the way the board's software requires.
  137.  
  138.  
  139. RagTag REGISTRATION
  140.  
  141. There isn't any.  Presumably you bought ProComm Plus in the commercial 
  142. market, so you should already have paid your dues to Datastorm 
  143. Technologies, Inc.  If you haven't yet registered John Hancock with Dan 
  144. Moore, be sure to do it. 
  145.  
  146.  
  147. RagTag SUPPORT
  148.  
  149. There isn't any.  If you should ask me anything about RagTag, I will 
  150. probably deny having written it.  You've heard of user-supported 
  151. software?  Well, this is it.  You're the user, you support it.
  152.  
  153.  
  154. BONUS SCRIPT (Sorry, not available for ProComm Plus)
  155.  
  156. With a couple of communications programs, I have been able to provide a 
  157. bonus script to display the name of the board with which you're 
  158. connected.  Perhaps you use a dialing queue and a log-on script to 
  159. handle things for you automatically.  All PCBoards look very much alike; 
  160. all Opus boards look very much alike.  Or maybe your memory is just 
  161. beginning to go.  For whatever reason, you may not be able to puzzle out 
  162. what board's screen is staring you in the face, and ProComm Plus is no 
  163. great help because it doesn't display the board's name on the status 
  164. line.  (If you use a dialing directory, it does display the board's name 
  165. immediately after the connection is made.  The problem begins when that 
  166. information scrolls off the screen.)  Unfortunately, so far as I am 
  167. aware, ProComm Plus doesn't have the necessary system variable (such as 
  168. _entry_name in Telix or $BOARD in Qmodem) which would let a script 
  169. display the name of the current board.  If someone can discover such a 
  170. variable and point it out to me, I'll be glad to work on a script.  In 
  171. the meantime, you're just going to have to pay attention to the message 
  172. ProComm Plus sends right after the connection is made.  (Or perhaps it 
  173. will still be available in the Redisplay buffer.  Try <Alt><F6>.)
  174.  
  175.  
  176. RagTag ACKNOWLEDGEMENTS
  177.  
  178. I'd like to say to Datastorm, Mark (Sparky) Herring, and Dan Moore that 
  179. RagTag would probably not have been possible without them.  But that's 
  180. not correct.  Without them, it's for darn certain that RagTag wouldn't 
  181. have been possible.  Without Datastorm's ProComm Plus program, there 
  182. would have been no ProComm Plus scripts; without Sparky's Qmail system 
  183. no one would have known what taglines were; and without Dan's John 
  184. Hancock program RagTag wouldn't have had a clue as to how to put a 
  185. tagline on the message.  And without Dan's documentation as a model and 
  186. an inspiration, I wouldn't have learned how to write documentation 
  187. files.
  188.  
  189. ---
  190.  * RagTag 0.03 *  If you can read this, thank Datastorm, Sparky, and Dan.
  191.